home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / bstrv150.zip / BSTRIV.DOC < prev    next >
Text File  |  1993-04-24  |  13KB  |  258 lines
  1.  
  2.                 B I G   S T A T E   T R I V I A   D O O R
  3.                 -----------------------------------------
  4.                             by Robert Butler
  5.                               VERSION 1.50
  6.  
  7.  
  8.      For those who love questions and answers, this BBS Door game will
  9.      prove quite entertaining.  It is simple to install and maintain, it
  10.      automatically resets itself at the beginning of each month and keeps
  11.      track of who answered which question correctly so they are not given
  12.      that same question again until the next month.  It can be played by
  13.      callers without ANSI capability, and full support of Aliases rather
  14.      than Real Names is supported.   In addition to regular play, CALLERS
  15.      CAN INPUT THEIR OWN QUESTIONS AND ANSWERS WHILE ONLINE and when
  16.      these questions come up a message will be displayed showing the Alias
  17.      of the person who created it.  This eliminates a lot of the work Sysops
  18.      commonly associate with trivia doors, along with users constantly
  19.      contacting the Sysop about incorrect answers.
  20.  
  21.      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%    
  22.      Big State Trivia Door will run on any BBS that is capable of creating a
  23.      drop file called DOOR.SYS, DORINFO1.DEF or DORINFOx.DEF.  If your BBS
  24.      software doesn't create one of these, there are several door conversion
  25.      utilities available through BBS's that will convert drop files to these
  26.      formats. 
  27.      MULTI-NODE SUPPORT: The Door will run in multi-node operation with
  28.      upto 4 nodes playing simultaneously.
  29.  
  30.                              INSTALLATION:
  31.                              -------------
  32.  
  33.               The File BSTRV150.ZIP SHOULD CONTAIN THE FOLLOWING:
  34.                  TRIVIA.EXE      The Door Program
  35.                  BSED.EXE     Question file Editor
  36.                  INSTALL.EXE     Creates the proper batch & config files
  37.                  BSHELP.ASC      Online instructions file
  38.                  BSTITLE.ANS     ANSI title screen file
  39.                  BSTITLE.ASC     ASCII title screen File
  40.                  BSMENU.ANS      ANSI Main Menu File
  41.                  BSMENU.ASC      ASCII Main Menu File
  42.                  BSTRIV.CFG      sample Config File
  43.                  SINGLE.BAT      sample Single Node Batch File
  44.                  MULTI.BAT       sample Multinode Batch File
  45.                  BSDATA.DAT      The sample Question & Answer File
  46.                  REGISTER.FRM    Registration Form
  47.                  BSTRIV.DOC      The file you're reading now
  48.  
  49.               Big State Trivia Door will create the following files:
  50.                  BSUSER.DAT      contains player info
  51.                  BSSCORES.DAT    contains top 30 scores
  52.                  BSTRIVIA.ERR    if game exits with an error, this file
  53.                                  will be created or added to
  54.                  
  55.                  And if you run more than 1 node:
  56.                  BSTRIVIA.USE    passes data between the nodes
  57.                  
  58.  
  59.      To install Big State Trivia Door:
  60.      1. Create a subdirectory to hold the Door Files.
  61.         Example:   C:\BBS\TRIVIA
  62.      2. Copy the files from BSTRV150.ZIP to the new subdirectory.
  63.      3. Using a text editor, create the necessary Config & batch
  64.         files that the door needs to run.  You can use the sample
  65.         BSTRIV.CFG and TRIVIA.BAT and edit them if you like.
  66.      4. Include a line in the apropriate BBS Menu that calls the Batch file.
  67.  
  68.                    The Big State Trivia CONFIG FILE:
  69.                    ---------------------------------
  70.  
  71.                           FOR SINGLE-NODE:
  72.                The Config file must be named BSTRIV.CFG
  73.                           FOR MULTI-NODE:
  74.             Config files must be named BSTRIV + NODE + .CFG
  75.  
  76.                   Example for node 1:     BSTRIV1.CFG
  77.                   Example for node 2:     BSTRIV2.CFG
  78.  
  79.      The Config File will be created for you when you run INSTALL.EXE
  80.      or you can create or edit it yourself with a text editor.
  81.      The Config file is a flat ASCII text file and can be easily created and
  82.      edited with a text editor.  The following example has comments & line
  83.      numbers written in for explanation only, DO NOT INCLUDE COMMENTS OR
  84.      LINE NUMBERS IN YOUR CONFIG FILE!
  85.      THE FIRST 2 LINES MUST BE ALL CAPS OR YOU WILL GET AN ERROR!
  86.      Lines 7 & 8 are case sensitive, so be sure to
  87.      enter them exactly or your registration key will not work!
  88.      
  89.  
  90. Line Statement       Description
  91. -------------------------------------------------
  92.  1  C:\BBS\         Path To Drop File(s) MUST BE ALL CAPS!
  93.  2  DORINFO1.DEF   drop file(DORINFO1.DEF,DORINFOx.DEF or DOOR.SYS)ALL CAPS!
  94.  3  N               Used internally DO NOT OMIT!
  95.  4* 0               Registration Key (zero for unregistered copies).
  96.  5  3               Games per Day Allowed. (3 if unregistered)
  97.  6  10              minutes allowed per play. (10 if unregistered)
  98.  7* Robert Butler   Sysop Name. CASE SENSITIVE-SEE NOTE BELOW
  99.  8* Lockhart BBS    BBS Name.  CASE SENSITIVE-SEE NOTE BELOW
  100.  9  C:\BBS\TEXT\SCORES.ANS  Path & Name of ANSI top scores file to create
  101. 10  C:\BBS\TEXT\SCORES.ASC  Path & Name of ASCII Top scores file to create
  102. 11  Star Trek                   
  103. 12  TV Sitcoms                   LINES 11 THROUGH 26 CONTAIN THE
  104. 13  Not so Famous 1sts           NAMES OF THE TRIVIA CATEGORIES
  105. 14  Famous Americans             THAT CALLERS MAY CHOOSE FROM.
  106. 15  General Knowledge            THERE ARE ORIGINAL QUESTIONS IN BSDATA.DAT
  107. 16  Name the Capitol             FOR THE CATEGORIES SHOWN HERE.  IF YOU
  108. 17  Who made this Quote?         WANT TO CHANGE ONE OF THESE, YOU MUST MOVE
  109. 18  Sports Trivia                OR DELETE THE QUESTIONS CURRENTLY IN THAT
  110. 19                               CATEGORY BY USING BSED.EXE ALL CONFIG FILES
  111. 20                               IN THE SAME DIRECTORY MUST CONTAIN THE SAME
  112. 21                               CATEGORY INFORMATION!  EVERY CONFIG FILE     22                               MUST CONTAIN ALL 26 LINES OR
  113. 23                               THE GAME WILL EXIT WITH AN
  114. 24                               ERROR!
  115. 25
  116. 26
  117.  
  118.      * Note: Lines 7 & 8 are case sensitive and must be input exactly as you
  119.      would like them to appear for the registration key to work. Lines 4, 7
  120.      & 8 must not contain any trailing blank spaces or hidden control codes.
  121.      If you are running an unregistered copy, you will not be able to change
  122.      the default values in lines 5 & 6 from the values shown.
  123.      That's all there is to it!
  124.  
  125.                     THE Big State Trivia COMMAND LINE:
  126.                     ----------------------------------
  127.  
  128.      To run the program from a DOS command line or from inside a batch file,
  129.      the syntax of the command line is:
  130.  
  131.                      TRIVIA NODE
  132.           Example:   TRIVIA 1          
  133.      NODE = The node number of the node you wish to run.  If you are running
  134.      a single node BBS then do not put a node parameter.  If you are running
  135.      a multi node BBS, You will need a separate batch file for each node.
  136.      Valid Range is 1 to 4.  If the Node parameter is omitted, single node
  137.      operation is assumed.
  138.  
  139.                      BIG STATE TRIVIA BATCH FILE:
  140.                      ----------------------------
  141.       Here is a sample batch file for a single node BBS, assuming the BBS is
  142.       in the Directory C:\BBS & the trivia files are in C:\BBS\TRIVIA:
  143.  
  144.                       ECHO OFF
  145.                       CD\BBS\TRIVIA
  146.                       TRIVIA
  147.                       CD\BBS
  148.  
  149.     While it is possible to use a separate batch file for each node of a
  150.     mutinode BBS, the single batch file method is preferred due to the
  151.     savings in disk space.  IF YOU PLAN TO RUN MULTINODE WITH A SINGLE
  152.     BATCH FILE, YOUR BBS SOFTWARE MUST BE ABLE TO PASS THE NODE NUMBER
  153.     TO THE BATCH FILE, SEE YOUR BBS DOCUMENTATION FOR DETAILS.
  154.     Please have a look at MULTI.BAT for an example of a multinode BAT file.
  155.  
  156.  
  157.  
  158.                        MENU LINE TO INVOKE THE DOOR:
  159.                        -----------------------------
  160.  
  161.      Big State Trivia DOOR requires approx. 150k to run single node and 215k
  162.      to run in multinode.  it should be invoked by means of a menu line that
  163.      shells out to a batch file.  For example, for QuickBBS 2.76 this is a
  164.      menu type 7 and the command line would be *C /C BATFILE.BAT , where
  165.      BATFILE is the name of the batch file that runs the Door.  If multinode,
  166.      use the following: *C /C BATFILE.BAT *N  The *N passes the node number
  167.      to the batch file.
  168.  
  169.                                SYSOP KEYS
  170.                                ----------
  171.  
  172.      The following keys are available to the sysop at the local console
  173.      while a user is online:
  174.              KEY                FUNCTION
  175.              ---            ----------------
  176.            UP ARROW      INCREASE CALLERS TIME LEFT BY 1 MINUTE
  177.            DN ARROW      DECREASE CALLERS TIME LEFT BY 1 MINUTE
  178.            ALT-C         CHAT WITH USER 
  179.            ALT-H         DROP CARRIER (HANG UP)
  180.            F1-F4         CHANGE STATUS BAR 
  181.            F10           REMOVE STATUS BAR
  182.            Ctrl-Break    QUIT GAME & RETURN TO BBS
  183.  
  184.                      
  185.                       EDITING THE QUESTIONS AND ANSWERS:
  186.                       ----------------------------------
  187.  
  188.      The File BSED.EXE is the editor for the questions and answers file.
  189.      With it, you can manipulate the individual questions in a variety of
  190.      ways and you can move every question in a category to a different
  191.      category if you desire. BSED is run by issuing the following command:
  192.  
  193.                               BSED NODE 
  194.      where NODE is the number of the Config file you wish to read.
  195.      Examples:
  196.      
  197.      Command Line:  Will look for this Config File:
  198.      ----------------------------------------------
  199.      BSED              BSTRIV.CFG
  200.      BSED 1            BSTRIV1.CFG
  201.      BSED 2            BSTRIV2.CFG
  202.  
  203.  
  204.      Callers are able to input their own questions & answers which will be          placed in a file called UPLOAD.DAT  When BSED is run you are prompted
  205.      for which of the 2 data files you would like to edit.  You can easily
  206.      scan new questions and answers by selecting to edit the Uploaded
  207.      Questions from callers.  You can then Edit or Delete them and then
  208.      Merge them into the regular game file called BSDATA.DAT.
  209.      
  210.  
  211.                             COPYRIGHT NOTICE
  212.                             ----------------
  213.  
  214.      Big State Trivia Door is a copyrighted program being distributed
  215.      under the shareware concept.  As such you may use Big State Trivia Door
  216.      for a period of 30 days  without  registering  the  software.
  217.      After  the  30  day evaluation period, you  must register your copy of
  218.      Big State Trivia Door or you will be in violation of United States and
  219.      International copyright laws.
  220.  
  221.      As a shareware program, Big State Trivia Door may be freely distributed
  222.      through a BBS.  Shareware distributors may distribute copies of Big 
  223.      State Trivia Door on disk for a modest disk duplication charge not to
  224.      exceed $6 per disk.
  225.                                 WARRANTY
  226.                                 --------
  227.  
  228.      Big State Trivia Door is  distributed without warranty.   In no event
  229.      will Robert Butler be liable to you for damages, including any loss  
  230.      of profits, lost savings, or other incidental or consequential damages
  231.      arising out of your use of or inability to use the program, even if
  232.      Robert Butler or an authorized representative has been advised of the
  233.      possibility of such damages.  Robert Butler will not be liable for any
  234.      such claim by any other party.
  235.  
  236.                                REGISTRATION
  237.                                ------------
  238.      Please use United States Currency ONLY!  Simply print the file
  239.      REGISTER.FRM and follow the instructions included in it.
  240.  
  241.      There are 3 different registration fee types for Big State Trivia Door:
  242.      1. Single Version Registration key is $15.00 U.S. This will work on the
  243.         current version of the Door only.
  244.      2. Unlimited Upgrade Key is $30.00 U.S.  This key will work on this and
  245.         all future versions of Big State Trivia Door.
  246.      3. Upgrade Key is $5.00 U.S. and is available to people who previously
  247.         Registered with a Single Version Key.
  248.  
  249.      The shareware copy you have contains all the necessary files, there
  250.      is nothing left out.
  251.  
  252.      Registered owners will recieve a registration key via BBS or Fidonet
  253.      NetMail Msg.   The registration key will unlock the # of Minutes per
  254.      Play & Plays Per Day config statements and will eliminate the
  255.      UNREGISTERED notices and beeps at the beginning and end of the game.
  256.  
  257.          Big State Trivia Door  Copyright 1993 by Big State Doors
  258.